Session
概述
可以直接使用think\facade\Session类操作Session。
| 版本 | 新增功能 |
|---|---|
| 5.1.3 | get方法支持获取多级 |
Session初始化
Session会在第一次调用Session类的时候按照session.php配置的参数自动初始化:
return ['prefix' => 'think','type' => '','auto_start' => true,],
如果我们使用上述的session配置参数的话,无需任何操作就可以直接调用Session类的相关方法,例如:
Session::set('name','thinkphp');Session::get('name');
或者调用init方法进行初始化:
Session::init(['prefix' => 'module','type' => '','auto_start' => true,]);
如果你没有使用Session类进行Session操作的话,例如直接操作
$_SESSION,必须使用上面的方式手动初始化或者直接调用session_start()方法进行session初始化。
设置参数
默认支持的session设置参数包括:
| 参数 | 描述 |
|---|---|
| type | session类型 |
| expire | session过期时间 |
| prefix | session前缀 |
| auto_start | 是否自动开启 |
| use_trans_sid | 是否使用use_trans_sid |
| var_session_id | 请求session_id变量名 |
| id | session_id |
| name | session_name |
| path | session保存路径 |
| domain | session cookie_domain |
| use_cookies | 是否使用cookie |
| cache_limiter | session_cache_limiter |
| cache_expire | session_cache_expire |
| secure | 安全选项 |
| httponly | 使用httponly |
如果做了session驱动扩展,可能有些参数不一定有效。
基础用法
赋值
// 赋值(当前作用域)Session::set('name','thinkphp');// 赋值think作用域Session::set('name','thinkphp','think');
判断是否存在
// 判断(当前作用域)是否赋值Session::has('name');// 判断think作用域下面是否赋值Session::has('name','think');
取值
// 取值(当前作用域)Session::get('name');// 取值think作用域Session::get('name','think');
如果name的值不存在,返回null。
删除
// 删除(当前作用域)Session::delete('name');// 删除think作用域下面的值Session::delete('name','think');
指定作用域
// 指定当前作用域Session::prefix('think');
取值并删除
// 取值并删除Session::pull('name');
如果name的值不存在,返回Null。
清空
// 清除session(当前作用域)Session::clear();// 清除think作用域Session::clear('think');
闪存数据,下次请求之前有效
// 设置session 并且在下一次请求之前有效Session::flash('name','value');
提前清除当前请求有效的数据
// 清除当前请求有效的sessionSession::flush();
二级数组
支持session的二维数组操作,例如:
// 赋值(当前作用域)Session::set('name.item','thinkphp');// 判断(当前作用域)是否赋值Session::has('name.item');// 取值(当前作用域)Session::get('name.item');// 删除(当前作用域)Session::delete('name.item');
助手函数
系统也提供了助手函数session完成相同的功能,例如:
// 初始化sessionsession(['prefix' => 'module','type' => '','auto_start' => true,]);// 赋值(当前作用域)session('name', 'thinkphp');// 赋值think作用域session('name', 'thinkphp', 'think');// 判断(当前作用域)是否赋值session('?name');// 取值(当前作用域)session('name');// 取值think作用域session('name', '', 'think');// 删除(当前作用域)session('name', null);// 清除session(当前作用域)session(null);// 清除think作用域session(null, 'think');
Session驱动
支持指定 Session 驱动,配置文件如下:
return ['type' => 'redis','prefix' => 'module','auto_start' => true,// redis主机'host' => '127.0.0.1',// redis端口'port' => 6379,// 密码'password' => '',]
表示使用redis作为session类型。
目前内置支持使用redis、memcache和memcached作为session驱动类型。